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1.0 Introduction. 

PEEK is a utility program desired to operate under the ITS 
tifcn sharing system* It enables a user to monitor a variety of 
aspects of the time sharing system by providing periodically 
updated display output tr periodic printed output to teletype or 
lint printer. 

Just what information is being presented to the user is 
cc moiled by PEEK'S imforci&tion mode* The av&iiabile modes are 
listed in section 3 below* Section 5 describes hew PEEK determines 
which device to output on* Section 2 de$c Titles, in general, how 
the user car; input commands to IEEK. 

The first line of all pages output by PEEK is as follows: 

ITS xxx PEEK yyy mm/dd/yy hh:mm:es STIKEkJJDihHiMfrtSS 

In this line xxx is the version number of the system in use and yyy 
is ihe version number of the PEEK in use (so bugs can be matched to 
the exact version)- At the time this memo was released, PEFK 2h3 
was the version in use* DD:HH;MM:3b is the length of time that the 
particular ITS system running has been up and mr/dd/yy hhimiss is 
the current date and tiu.e according to ITS. 

For Dan'' modes (those with the E-Ode letter jwst after the 
sub-section number underlined in seetier 3) & standard second line 
is output for any core or disk memory error. This line lists the 
following tJree errors if any h&ve cccureds 

1, Irrecoverable disk errorr. 

2, Core memory j&rity errors. 

3, Core memory failures to respend (NXM)* 

The last line oi all pages output to the J4C display by 
Fill is a list of ttode command letters which can be given by light 
|tenring them {this has the same effect as typing them would). 
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2.0 Command Formats - 

PEEK is an unusual jrogrhin in that it immediately 
interprets all characters typed at it at the interrupt level* 
CcuemdE to PEEK are ail single letters or control characters, 
sometimes preceded ty & numeric argument, The commands listed in 
sections 5 and 6 of thir memo take effect immediately and do not 
affect any number that JEIFK may be accumulating from d if its typed 
into it. 


The ccmcandr lie ted in section 3 change PEEK'S information 
mode* They may or uay rot r;^ke use of a numeric argument hut a31 
clear ary number JPE1K j aay have accumulated. These commands 
nor],.ally start PEEK immediately displaying the information 
requested. 

PEEK interprets digits typeo at it as forming ari octal 


numler* 
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^0 Information Wodes /.veilable 

Belov are listed all the different information inodes of 
I'tfjK, Normally, the information specified by the current 
1 nil mat ion Liode is out] ut tc the currently selected output device 
[sot. section 5)* After PEEK has dore this it waits a while and 
then rejeats. This waiting period is fixed at ten seconds for pome 
micrc-ation modes that display infonsation that is not expected to 
charge* for most modes, the waiting time is initially ten seconds 
but can be changed by the 2 command, (sou section 6)* 


5*1 A ARPA Network Sockets 

The active ARPA network sockets and pseudo-tele types in the 
system are listed by this mode. After a heading line* tne line of 
information is given for each socket with the fellowipg 
information; O) the socket's logical index number; (£) the index, 
UK AM. and J1AME: of the user associated with the socket; (5) the 
locil socket number and the state of the socket ; (4] the foreign 
host ano socket number associated with the socketj (5) the 
cut? tending message and bit allocations on the socket* 


If any jseudo-tcletypes (STY) are in use, they are listed 
below all the sockets urder a different heading line. On each line 
is 1 is ted the following:: (1) the user index, URAUE and JNAME of 
the procedure that has the LTY open as a teletype; (2) the teletype 
numier of the STY j (J) the UltA m of the iob that has the other end 
of the STY open* 


J *2 C bisk Channels 

This mode lists the channels actually in use for the 
trar si or of infcrmation between disk files and procedures* After 
explanatory 3-coding line, one line is displayed for each charnel 
with the following information: (1) the logical channel number: 

UO the index, UMAKE and JNAKE of the user procedure that has the 
cn&inel epen; (5) various status letters as listed in the next 
paragraph; (4) a count of the number of words transferred; (5) 
the system name and two file names of the file. 

The following ere the disk transfer status letters that can 
appear in the disk channels mode output: 

A File addresf altered bry * ACC ESS or not* 

B Core transfer hung on active buffer* 
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E Transfer har reached ECU'* 

J hun£ in directory full* 

L Channel locked* 

H Harter directory read* 

F FUUf-iF mode transfer* 

JR head* 

T Track Usage Table read* 

1J User directory read, 

V Write* 

? Parity error on read* 

* Delete file when channel closed. 


3-3 D Disk Directory 

This mode displays the disk master file directory ("M.TVD* 
(FIJE) 1 ');, which lists the names of all ihe user directories* and 
the* lists the user directory ( 1h *FILE* (DIfi) w ) for the current 
default system name associated with PEEK* if output is to the 34-0 
display, it may be possible to change this default system name by 
light penning one of the names in the naster directory display* 


3*4 G Ewap/Schedule Variables 

This mode displays information very similar to sode N with 
certain additional data related to the ITS scheduler & swapping 
routines* In particular, the interrupt request words in the per 
job information are replaced by the number of page swap in requests 
and the total run time Used is replaced by the average recent lead 
represented by the job in page-miHiseconds* 

In addition, an extra line is displayed for each tor level 
job shoving the average percent of machine time used anti the load 
in j age-milliseconds for the tree topper] by that job {but note that 
all disowned jobs are combi red)* 
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3*5 Ji Memory Grajph Disj lay 

This reode is only available on output to the 340 display. 

It 4 hows a graph of actual core memory usage, horizontal position 
represents absolute address and vertical position represents type 
of use. Words are displayed on the left edge of the screen which 
describe the use opposite the*. The ooeurarce of a block of memory 
at several vertical positions represents a shared block. {See also 
mode to.} 


3-6 I Available l /C Devices 

The symbolic devices implement (id in the ITS system in use 
are listed by this mode. Output is repeated after a ten second 
delay. 


3-7 L Console lines 

This mode simply outputs the system supplied directory for 
device TTT, 


3-S to Memory JJee List 

A display is provided by this node of all of the uses tc 
which actual core memory is being put* After ar explanatory 
heating line, one line is shown for each use in decreasing order by 
actual core memory occupied. 

Each line begin?- with the type of use* either the UMAME and 
JMME of a procedure or a single descriptive word such as "IltEE" 
for unused actual memory or *BSWBUF" for disk transfer buffers. A 
"*** is displayed just af ter the names of a stopped job. After the 
typt of use, the total number of actual core blocks dedicated to 
that use is listed followed (in the case of procedures} by; ( 1 ) 
the number of the highest virtual page slot in use in that 
procedure ; (£) the number of its pages that are shared with some 
other procedure; ( 3 } the number of its pages that are not in actual 
memory tut have'■beer, swapped out; ( 4 ) the total number of page 
slots in use by the procedure; {£) the resources in use by the 
procedure (see section 4*1}* 


3-9 N Kormal Mode 
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This is the initial and west commonly used information 5. ode 

in IEEE* 


5*9 ,1 The Top 

After the noriai top display lines {see section 1} # !£ mode 
displays one line of special information in the form of several 
vanj able names followed by their values* These names, are as 
follows: 


HEMFREE Kucher of blocks of unused actual core memory* 

dbREI Number of blocks of user variables currently 

allocated in the system* 

RNAELU Number of runsLle users (including the PEEK 
displaying it}* 


TRUkH Total user memory blocks Of active users, 

AUSC'FG Number of active titer swapped cut blocks (pages)* 


5*9* £ The Kiddle 

After the special information listed in the section above, 
a heading line is displayed followed by one line of information per 
job. The tree structure of jobs is shown by the indentation of the 
first few items after the user index number on each line* Top 
level console controlled* disowned, or system jobs are leftmost* 
Under each procedure appears its inferiors which are indented one 
spiu-e, and its second If vel inferiors which are indented two 
spaces* 


The information appearing for each job Is as follows: (1) 
the user index, UNAhE* JKAKfc., and current system name* {£) the run 
status* teletype status, and resources seized (see section 4 ); ( 5 ) 
the number of blocks of memory in use by the job anti the number of 
such blocks that arc swapped out* ( 4 ) the average percent of 
available machine time used recently by the job 3 : ( 5 j two words of 
possible pending interrupts for the job; ( 6 ) the total amount of 
actual run tirne^ that has been used by the job. The proceeding list 
applies to output to the line printer or 540 display (see section 
91* Other outiut is abbreviated by dropping some of the 
Information* In particular, the JNAME la dropped for top level 
noth-disowned jobs and the Ui-AHE dropped for their inferiors* 
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The Bottom 

Space permitting , two lines of Ej-ocial information are 
cutjut at the bottom of the h mode diEpd-ay, The first Is a line of 
totals which fives the total memory in use by all listed jobs {no 
deduction is made for shared pares } t the average total percent of 
machine time used recently by listed jobs, and the total run time 
used by all listed yobs. 

The last line shows the total amount of run time for ail 
users that friave logged out during the system run so far, the amount 
of machine time used by jots killed toy users vho are still logged 
in, and the amount of run time for the null job* 


3*1C S Single Tree 

This mode outputs the same information in the same format 
as the h note except that only jroceedures in a single job tree are 
included. The h cou.manc should be proceeded by the user index of a 
job in the tree to be displayed* If no argument is given the tree 
coni aining the FEEK will be displayed. 


3.11 T Translation Table 

The from and to device, ays tea name, file names, and 
applicability of the system translation table entries are listed by 
this mode. 


U Ilf Tape Channels 

This mode is Similar to the c mode for dish except that it 
aj.j lies to the l)EC tape drives* In addition to listing information 
for oper channels, it lists various information for each drive. 

Ihir per drive information includes the directional motion status 
of the drive, the tape block to which the system is trying to move 
it, and the current fcelievet position of the tape. Also listed for 
eacl drive is a directory pointer, the UNAMl of the user who lart 
caused e directory to k read in for that drive, and the UHAME of 

the user, if any, to whom the drive is "assigned■% 

% 

If the directory pointer for a drive is —i it means that 
the system is not retaining a directory for that drive and the tape 
can bE safely flapped by hand. Otherwise, the directory pointer 
gives the location in memory' of the tape's director;-. Iven after a 
tape- has been flapped aid nc directory is being retained for it, 
this mode displays the UKAKL' of the last job to cause a directory 
to be road in from that drive* 
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3 m Y' V Siftfle froceduro Variables 

Many of the user Variables for a single procedure can be 
viewed with this mode* After shoving the procedure's mines, run 
status, and resources, the octal value of a number of named 
variables are displaced* Then, under a heading line, the contents 
of the procedure's ACs, input-output channel words and input—output 
status words art: listed, For open channels, the device and mede 
symbol is also shown. 


3*1 i. X A/D and D/A Multiplexors 

This inode outputs the digitalization of all the multiplexed 
analog to digital input channels and the value being output at each 
of the li.ultiplexed digital—to-analog channe]s* 


1 DEC Tap* Directory 

This mode simply outputs the system-supplied directory for 
a particular DEC tape* It should be preceded by a drive number. 


3, \L ? Explanation Mode 

This mode outputs a list and brief expOatiatj.cn cf PFEK's 
coiu-.andr* Output is rej eated after a ten second delay* 
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4 *0 Special Output field Fcrcaats 


i],l Resource Letters 

The folio wire are the ays ten. resource letters used in modes 
C, h, S, and V explained abovej 

6 The procedure hae centre1 of the PDP-6, 

B The procedure has control of the IEfl cwpatihle 

magnetic tape drive (MTU), 

C The procedure is now using, or Was the last to use, 
the IT'S core allocator. 

D The procedure has control of the DEC 340 display (DIS). 

_I The procedure is in "lOX-ueer" node. This letter 

can he present for sore than one procedure {*IOTLSR}. 

L The procedure has control of the main line printer 
(LPT). 

M The procedure has seized, the master user facility 
(.MASTER)* 

0 The procedure has control of the old line printer 

~ ( 011 % 

P The procedure has control, of the CalComr plotter (PLT)* 

R The procedure has control of the paper tape reader 

“ (PTR), 

S The procedure has control of the SyiVania tablet (TAB). 

T The procedure has control cf the paper tape punch 

“ (FIT), 

V The procedure has control of the vidisector (MVD)* 

^ The ’proceduie is in real time mode (*REA1T), 


4*2 Process Run Status 

The following secticns explain the procedure run status 
field output, by modes G, ft, £, and V: 
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4*2,1 Prefix 

One of the following characters will appear at the 
beginning of the status code; 

> Swap blocked. This procedure is being blocked fro® 
running try the swap scheduler to stop thrash lag* 

Desired out. This procedure is not swat: "blocked hut 
the swap scheduler has decided to swap it out. 

* FI is progress* This procedure is rot swap blocked or 
desired out hut is processing a software interrupt* 

(Space) None of the aheve apply* 


4.2*2.1 Body If Stopped 

If a procedure is slopped, the body of its status field is 
a number output in an unusual format* The first two octal digits 
of the number are printed as an unsigned number, then an "J 11 is 
outjut, then the rest of the number with leading zeros is 
el it. i rated* The resulting figure to the right of the lf t*' is the 
court of transient reasons for the procedure to fee stopped* If 
thir count is persistently non-zero, an internal system error has 
probably occured* 

In the figure to the left of the the top four hits 

have special meaning, Ihe 40 and 20 bits are used fey the core 
allocator when it is moving or modifying the core imge of 
procedures* The 10 fell is the most coirmon and is the only hit 
directly controllafeQe tj user procedures to start and stop ether 
procedures. The 4 bit is used as a temporary stop tit by seme 
syslem calls, 3f the 4C, 2C, or A bits stay on persistently, there 
is j robably something wrong. 


4*2,2,2 Body If Hung 

A procedure can he hung (execution tempcTurily blocked) 
either due to waiting for a page of its core image to be swapped in 
or due to a wait for some condition in the execution of a system 
call* 

In the case of a hung system call* PEEK simply displays the 
name of the system call or, for art input«output transfer, the 
device name arid transfer type* If tbe procedure is blocked waiting 
for a page to be swapped in, the word '•PAGE* is displayed, unless 
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the rage is needed to handle & software interrupt tc the user in 
which case "IFACE" is displayed. 


4,£.£,3 V Ecdy If Kunming 

If a procedure is running in user node, the word is 

displayed as the body of its status field* If it is executing a 
sysiejii calif the sa^e wcrd is displayed as if it were hung in that 
ey&tea call (see section 4*2,2,2) except that a “+ ,f is added in 
front. There are several reasons, however, that a procedure car be 
rum ing in executive mode without having, executed a normal system 
call, lor example, if the procedure has just exeexuted an illegal 
instruction, M 3utX* will be displayed, and if it has just executed a 
UUO that will be reflected tact to it as a user UUG, the word "UUO" 
will be displayed. 


4,2* 3 tuffix 

Under some circumstances., & system call being executed by a 
procedure, FI for example, will have to make sure that a second 
procedure* F£, is net running temporarily in executive mode- This 
may necessitate PI waiting until F2 is interruptible if P2 is 
initially running in executive mode. If PEEK is rur'; during this 
waiting stale, s. 11 >" followed by the user index of P2 will appear 
at the end of the statue field for pi and a W < IF followed by P1 # e 
index ccrreej^ondingly after status* This situation is refered 

to as PI PClCRing (P-C-Iosering;) F2_ 

This state should be extremely transient, if you see this 
suffix display even once, you should suspect some problem. 


4-5 Process Teletype Status. 

The teletype status field displayed for a procedure will be 
one of the folicwing five thingsi 

DISOWN The procedure is disowned and can not have a 
console associated with it, 

Tn The procedure is immediately controlling and being 
controlled by "teletype* 1 number n* 

> The procedure has assigned its teletype downward in 
its procedure tree. The number should be displayed by one of Its 
inferior procedures. 
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< The procedure inas had its console taken away ty a 
higher level procedure. The number should t« displayed by some 
other procedure in its procedure tree* 

? There is nc evidence oi a cenacle ever being directly 
associated with the procedure (It might be a newly creeled 
inferior}* 
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5*0 I/O Control 

PEEK has four different modes of output (not to be confused 
with the information modes listed in section 3). iVo of these, 
which provide the most verbose output, are intended for output to 
the line printer and the 34c display. The remaining two modes are 
for printinf consoles (teletypes} and alpha-numeric display 
consoles (DatapointE). 

The exact information displayed for various information 
modes is affected fry this Output mode. Especially for the more 
com i lex information modes, 11he W, there is an abbreviated version 
of the output for printing consoles, an intermediate one for alpha¬ 
numeric displays, and a Complete version for the line printer ard 
340 disjlays. In the descriptions of information modes, usually 
the most complete output form was explained, 

PEEK starts in either the printing or alpha-numeric display 
modes, depending on tho nature of the user's console, unless it 
fines that the user's console is at a 340 screen or it cannot open 
device TTY for output. In either of those two oases it tries to 
use the 340 display output mode (If the 340 display is rot tried, a 
flap is set which is cleared only by “Y which inhibits further 
attempts at Rising the 340). The following commands can be used to 
charge JEEJC's output mode* 

'll This switches output to the line printer if it is 
available* If it is not available, the output device will be 
unchanged.* 

“E This cemnard releases the line printer if PEEK is 
using it* It then resets the output mode through the same 
procedure used when PEEK is first started. 

~jN This ccmnard releases the 340 display, if 1-EEK is 
using it, and then it sets a flag which inhibits any PEEK attempt 
at using the 340. This flag is cleared only by ~y, Finally, PEEK 
charges to type cut or alpha-numeric display mode, 

"Y PEbK will try to seize the 340 display for output on 
receipt of this coumand. If it succeeds, the output mode will lie 
sot to the 340, Otherwise, output will revert to the user's 
console. In either case, the flag mentioned under “H above is 
cleared* 
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6,0 Miscellaneous Commands 

The following are miscellaneous PEEK copB ands: 

P This is the proceed goto: and* 

If PEEK is running under a ]iACTF<lf r this compand will 
re tern control of the user's console to HACTKN tut leave the PEEK 
runt.i he. If 54L- dieplsy or line printer output is selected, it 
will continue* If the 1EEK is running as a top level job, this 
com.and will Cause it tc logout* 

The P comtiard uses *VALUE to return the string w :J?flCCED " 
to iEEK's superior procedure* 

■Q This is the guit command*. 

If PEEK is running under a PACTRUf this command will 
destroy the PEEK it is typed at and return control of the user's 
console to PACTIiAN* If the PEEP is running as a top level job, 
this coEHiand will cause it to logout* 

The Q coamand uses * VALUE to return the string n :KIIl " to 
Peek's superior procedure. 

2 This is the doze command- 

It takes a numeric argument and sets the standard 
updi. te delay to that number of seconds (see section 3)* 

(Space) This is a sort of null mode conanc* It does 
not charge PEEK'S in formation node tut causes it to immediately 
begin updating the current output* 
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